home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / Add-Ons / After Dark / ScreenFlip 1.5 / ScreenFlip README < prev   
Text File  |  1995-12-05  |  7KB  |  174 lines
  1. _______________________________________________________________
  2. SCREENFLIP 1.5  —  A freeware Screensaver Module
  3.  
  4. By Leo Breebaart, Copyright ©1994-95 Kronto Software
  5.  
  6. Internet e-mail: leo@cp.tn.tudelft.nl        
  7. Internet WWW page: http://www.cp.tn.tudelft.nl/leo/kronto.html
  8. _______________________________________________________________
  9.  
  10.  
  11. Description
  12.  
  13.     ScreenFlip performs ‘animated’ horizontal and vertical flips of your
  14.     screen’s contents. Silly, no?
  15.  
  16.  
  17. Features
  18.  
  19.     •  Compatible with After Dark (both 2.0 and 3.0), DarkSide of the Mac and UnderWare.
  20.     •  Flicker-free animation.
  21.     •  Does not use any permanent System memory under After Dark 2.0.
  22.     •  Has an animated About Box and thumbnail.
  23.     •  Runs under both MultiModule and the Randomizer — without crashing.
  24.     •  Comes with extensively documented source code (CodeWarrior 7 C format).
  25.     •  Both the module and the source code are free.
  26.  
  27.  
  28. Restrictions & Technical Remarks
  29.  
  30.     •  ScreenFlip needs Color QuickDraw to run. A color screen is not essential, 
  31.     however: on a Black & White SE/30 the module works just fine.
  32.  
  33.     •  Multiple-monitor setups are supported, but not actively used — the animation
  34.     always runs on the main monitor only (and will simply black out any other screens).
  35.  
  36.     •  ScreenFlip tries to be a well-behaved, system-friendly module. It will,
  37.     for instance, not reserve any permanent memory in your system heap. That
  38.     means that having ScreenFlip selected costs you no more memory than having
  39.     the default ‘Starry Night’ module selected.
  40.  
  41.     •  The ‘Instant Flips’ option uses a lot of (temporary) memory. If the module 
  42.     won’t run because of this, you can try quitting one or two applications.
  43.     Otherwise you can just uncheck the option. There’s no need to restart.
  44.  
  45.     •  I cannot guarantee that ScreenFlip will work with versions of After Dark
  46.     earlier than 2.0u. The same holds for any other programs that are supposed
  47.     to be able to play After Dark modules (except for DarkSide and UnderWare,
  48.     which I had access to). In all such cases, ScreenFlip may run, or it may not.
  49.     Feedback about compatibility issues will be much appreciated.
  50.     
  51.     •  At the moment of writing the latest version numbers of the screensavers
  52.     ScreenFlip has been tested to work with are 3.0b for After Dark, 4.2 for DarkSide
  53.     and 1.0.1 for UnderWare. Free updaters for these programs are readily available
  54.     on the Internet and on all the major commercial software archives. See also the
  55.     URL appendix at the end of this document.
  56.  
  57.  
  58. Version history
  59.  
  60.     1.0        28 Jul 1994
  61.                         —    Initial release.
  62.  
  63.     1.1        24 Feb 1995
  64.                         —    Fixed a bug that made the About Box animation use the same inter flip
  65.                                 delay as the real module, instead of  no delay at all, which was the
  66.                                 intended behaviour.
  67.                         —    The About Box now wil take advantage of After Dark 3.0’s expanded
  68.                                 about box area (provided you’re running 3.0, of course. Duh.).
  69.                         —    Added animated thumbnail for After Dark 3.0.
  70.                         —    Cleaned up the source code.
  71.  
  72. 1.1.1    19 May 1995
  73.                         —    Documentation update. No changes to the actual module.
  74.                         —    Removed all references to the After Dark FTP Site and the Programmers’ List,
  75.                                 because both are now (temporarily) defunct.
  76.  
  77. 1.5            5 December 1995
  78.                         —    ScreenFlip is now a FAT module that will run native on PowerMacs, provided
  79.                                 you are using After Dark 3.0 or later.
  80.                         —    Code ported to CodeWarrior.
  81.                         —    Many internal improvements to the code and the project structure. The module
  82.                                 should now react much more gracefully to error conditions.
  83.                         
  84.  
  85. Credits & Acknowledgments
  86.  
  87.     Frits Kuijlman did the initial port of the code from THINK C to CodeWarrior, and helped me
  88.     figure out how to get the module to run native on a PowerMac.
  89.  
  90.     Neither Frits nor I would have had much success, however, if Robert Geisler had not shown
  91.     us the way. Without his Fat Module code this version of ScreenFlip would not have happened.
  92.  
  93.     The text shadowing effect in the module’s About Box was created using the
  94.     freeware Adobe Photoshop plug-in filter Drop Shadow, by Alien Skin Software.
  95.  
  96.     As always, thanks to Lloyd “Screensaver FAQ” Wood for feedback and
  97.     beta-testing.
  98.  
  99.     ScreenFlip was created using CodeWarrior 7,  Think Reference 2.0.1,
  100.     ResEdit 2.1.3, BBEdit 3.5.1, and Adobe Photoshop 3.0.1.
  101.  
  102.  
  103. Known Problems
  104.  
  105.     •    Under certain very rare circumstances (specifically: if you have a
  106.     multi-monitor setup in which your main monitor (the one with the menu
  107.     bar) is not placed in the ‘left-upper-most’ position in the Monitors control
  108.     panel) the module will start drawing garbage on your screen when
  109.     activated. This is an entirely cosmetical bug, and I know precisely what’s
  110.     causing it — I just don’t know how to fix it, yet.
  111.  
  112.     •    Under certain other not-so-rare circumstances (specifically: if After
  113.     Dark starts displaying a “Please Wake Up” message while the module
  114.     is running, e.g. when a background application wants your attention) the
  115.     module will also start drawing garbage to your screen. This too, is an entirely
  116.     cosmetic bug — but I’l be darned if I know what’s causing it, or how to
  117.     fix it.
  118.  
  119.     I would appreciate hearing about any other bugs or problems you may encounter 
  120.     with ScreenFlip.
  121.  
  122. For Programmers
  123.  
  124.     The most recent version of the After Dark programmer’s interface (which
  125.     also gets updated every now and then — the copy you have may
  126.     be outdated!) is available from the major Internet archive sites such
  127.     as sumex.stanford.edu, mac.archive.umich.edu and their mirrors.
  128.  
  129.     The best place to browse if you want to program After Dark modules,
  130.     though, is the Photon Farmer’s FTP site (or their Web pages). You will find
  131.     all kinds of After Dark modules and resources there, and these guys also 
  132.     maintain the After Dark Programmer’s mailing list (archives accessible!)
  133.  
  134.     You may also want to take a look at The Swarm, another screensaver module
  135.     I wrote, which also comes with documented source code.
  136.  
  137.  
  138. Final Remark    
  139.  
  140.     Nobody who owns a Macintosh screensaver package should be without
  141.     the most recent version of Lloyd Wood’s Screensaver FAQ (Frequently 
  142.     Asked Questions) List. Copies of this list are also available from all major
  143.     archive sites on or off the Internet. It is a must-have.
  144.  
  145. Enjoy,
  146.  
  147. __
  148. Leo Breebaart (leo@cp.tn.tudelft.nl)
  149.  
  150. _______________________________________________________________
  151. Appendix: URLs
  152.  
  153.     Here are URLs for some of the Internet resources mentioned in this document.
  154.     Newer versions of these files may of course have been released by the time
  155.     you read this. Most of the files are available from many other sites as well.
  156.  
  157.     Kronto Software WWW/ftp sites (for info about me and my other programs):
  158.                 http://www.cp.tn.tudelft.nl/leo/kronto.html
  159.                 ftp://kronto.cp.tn.tudelft.nl/pub/macintosh/
  160.     Photon Farmers After Dark Mailing list and FTP Site
  161.                 http://www.phofarm.com/
  162.                 ftp://ftp.phofarm.com/pub/screensavers/mac/afterdark/
  163.     Robert Geisler's Fat Module example code
  164.                 ftp://ftp.phofarm.com/pub/screensavers/mac/afterdark/Fat_Module_Source.sit.hqx
  165.     DarkSide of the Mac 4.2:
  166.                 ftp://ftp.apple.com/dts/mac/hacks/darkside-of-the-mac-4-2.hqx
  167.     Macintosh FAQs WWW/ftp sites:
  168.                 http://www.astro.nwu.edu/lentz/mac/faqs/home-faqs.html
  169.                 http://www.ee.surrey.ac.uk/Personal/L.Wood/screensavers/
  170.                 ftp://rtfm.mit.edu/pub/usenet/news.answers/macintosh
  171.     Drop Shadow 1.1g:
  172.                 ftp://ftp.euronet.nl/Mac/info-mac/gst/grf/pshp/drop-shadow-11g.hqx
  173. _______________________________________________________________
  174.